home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1995 November / Macworld Nov ’95.toast / Developers / Flex 2.5.2 / Read Me - Flex 2.5.2 < prev   
Encoding:
Text File  |  1995-06-30  |  3.0 KB  |  55 lines  |  [TEXT/ttxt]
  1.              Flex 2.5.2 for MPW Release 1
  2.                                                       30 June, 1995
  3.  
  4. Ported by:   Christopher E. Hyde
  5. Email:       drjekyll@hylight.demon.co.uk
  6. Address:     HyLight Limited
  7.           25 Carson Road
  8.           London  E16 4BD
  9.           England (UK)
  10.  
  11. Flex is a fast lexical analyser generator for C and C++.  It is derived from software contributed to Berkeley by Vern Paxson and is copyright the Regents of the University of California.  This is free ware.
  12.  
  13. Pursuant with the rules on copying: This product includes software developed by the University of California, Berkeley and its contributors.
  14.  
  15. THIS SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  16.  
  17. Please send all comments, queries, suggestions, offers of work and contributions (monetary or otherwise) to me at either of the above addresses.  Cash or work from any commercial users would be especially appreciated, as I have to make a living from writing software as I am self employed.
  18.  
  19. This release contains only the source files necessary to build Flex for the Mac and MPW.  The original, and complete, source is available from any good GNU ftp site.  This release features:
  20.       • all Flex and BYacc tables stored in resources
  21.       • skeleton source tuned for MPW
  22.       • skeleton source in ‘TEXT’ resource 128 (easily editable)
  23.       • fully formatted MS Word (5.1) manual
  24.       • some bug fixes to the original 2.5.2 source
  25.  
  26. The binary version of Flex was created using MPW 3.4b4 and Symantec C 8.0.1c11 and the 2.0a3 universal headers, all from ETO #17. (It does not use the new runtime libraries).  Although it will work with earlier version of any of these it may well require additional changes to the source code.
  27.  
  28. Recompiling
  29. To recompile the source code enter the following lines into an MPW worksheet:
  30.  
  31.       Set CDebugOpts '-opt off -mbg on -d YYDEBUG=1'
  32.  
  33. if you want the ‘debug’ version, or
  34.  
  35.       Set CDebugOpts '-opt all -mbg off'
  36.  
  37. if you want the ‘no debug’ version.  Then, assuming the source files are in the folder ‘flex-2.5.2’ on a disc called ‘Ram’, enter:
  38.  
  39.       Directory 'Ram:flex-2.5.2:'
  40.       BuildProgram Flex -d Prog='Ram:Flex' -d S=`Directory` ∂
  41.                         -d O='Ram:Obj:' -d CDebugOpts="{CDebugOpts}"
  42.  
  43. The ‘Prog=’ specifies the target binary file,
  44.    ‘S=’ specifies the source directory (which should be the current directory),
  45.    ‘O=’ specifies the object files’ directory, and
  46.    ‘CDebugOpts=’ specifies any extra options for the C compiler.
  47.  
  48. You may ignore the 5 ‘possible unintended assignment’ warnings while compiling ‘parse.c’.  Note: compiling the file ‘scan.c’ with the ‘-opt all’ option may take several minutes.
  49.  
  50. To Do:
  51.       • Auto generation of resource files
  52.       • Build a PowerPC version (unfortunately I only have a Powerless™ Macintosh ;-()
  53.       • Change to GNU’s getopt for greater consistency
  54.       • Provide a commando interface
  55.       • Produce a manual in a more ‘politically correct’ format